home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / dp.zip / DP.HLP < prev    next >
Text File  |  1992-07-03  |  31KB  |  481 lines

  1. Configuration,20                                              |
  2. File,44                                                       |
  3. New File,67                                                   |
  4. Open File,79                                                  |
  5. Exit,90                                                       |
  6. Slices,98                                                     |
  7. Add Slice,132                                                 |
  8. Update Slice,169                                              |
  9. Remove Slice,192                                              |
  10. Reports,199                                                   |
  11. Slice List,218                                                |
  12. Slice Status,228                                              |
  13. Crumbs List,255                                               |
  14. Slice Monitor,278                                             |
  15. Window,306                                                    |
  16. Clear,311                                                     |
  17. Print,315                                                     |
  18. Example of Use,328                                            |
  19. TEXT_TERM, ---------------------------------------------------|
  20. Configuration                                                 |
  21.                                                               |
  22. Once installed, Disk Police has several configuration options,|
  23. controlled by statements entered into the DP.INI file.  Use   |
  24. of these statements is documented below.                      |
  25.                                                               |
  26.                                                               |
  27. DP.INI has statements of the form:                            |
  28.                                                               |
  29.     [DISKPOLICE]                                              |
  30.     DataPath=C:\DP\                                           |
  31.     SliceLimit=XXX                                            |
  32.                                                               |
  33. The DataPath variable tells the program where to look for     |
  34. the standard Slice data file (DP.DAT) and the help file       |
  35. (DP.HLP).  These files may be located in any directory you    |
  36. choose.                                                       |
  37.                                                               |
  38. The SliceLimit variable is used to increase the limit on the  |
  39. maximum number of slices.  Set this to a value from 0 to 100. |
  40.                                                               |
  41.                                                               |
  42. TEXT_TERM ----------------------------------------------------|
  43. File                                                          |
  44.                                                               |
  45. The File menu item allows you to create and open Slice data   |
  46. files.  A Slice data file is the place where Slices are       |
  47. stored (see Slice help for more information).                 |
  48.                                                               |
  49. When Disk Police starts, the standard data file: DP.DAT is    |
  50. always opened automatically for you.  This file may be the    |
  51. only one you ever need.  Slices that you create will be       |
  52. automatically saved in this file every time you exit, and will|
  53. be loaded from this file every time you start the program.    |
  54.                                                               |
  55. If you wish to maintain multiple slice files, or if you wish  |
  56. to name the file something other than DP.DAT, use the New File|
  57. and Open File menu items to create a new file and to open it. |
  58.                                                               |
  59. The File menu popup also displays the name of the currently   |
  60. open file.  This will be DP.DAT at startup, but will change as|
  61. you open other files.                                         |
  62.                                                               |
  63. Remember that slices are always automatically saved in the    |
  64. file whenever you exit the program or change to another file. |
  65. TEXT_TERM ----------------------------------------------------|
  66. New File                                                      |
  67.                                                               |
  68. The New File menu item creates a new Slice data file.  A      |
  69. dialog box will pop up allowing you to change directories and |
  70. view existing files.  To create a new file, change to the     |
  71. directory where you want the file to reside and type the name |
  72. of the new file in the edit box.  When you press OK, the file |
  73. will be created, ready for storage of new slices.             |
  74.                                                               |
  75. New File automatically closes any currently open Slice data   |
  76. file, saving all slice data in it.                            |
  77. TEXT_TERM ----------------------------------------------------|
  78. Open File                                                     |
  79.                                                               |
  80. The Open File menu item opens an existing Slice data file and |
  81. loads all of the slice data in it.  A dialog box will pop up  |
  82. allowing you to change directories and pick the file you wish |
  83. to open.  You may also type the name of the file to open in   |
  84. the edit box.  Press OK to open the file.                     |
  85.                                                               |
  86. Open File automatically closes any currently open Slice data  |
  87. file, saving all slice data in it.                            |
  88. TEXT_TERM ----------------------------------------------------|
  89. Exit                                                          |
  90.                                                               |
  91. The Exit menu item exits Disk Police.  This is identical to   |
  92. Close on the System menu.                                     |
  93.                                                               |
  94. Exit automatically closes any currently open Slice data file, |
  95. saving all slice data in it.                                  |
  96. TEXT_TERM ----------------------------------------------------|
  97. Slices                                                        |
  98.                                                               |
  99. A slice is a portion of disk space, with a designated owner.  |
  100. You define slices for a disk in order to manage its space.    |
  101.                                                               |
  102. A slice is defined by selecting from 1 to 10 directories from |
  103. the disk and providing a maximum slice size limit.  Any       |
  104. directory or sub-directory may be used in a slice definition, |
  105. and directory names may appear in more than one slice defini- |
  106. tion.                                                         |
  107.                                                               |
  108. The owner of a slice is responsible for maintaining all files |
  109. within the directories that make up the slice so that the     |
  110. total disk space consumed does not exceed the maximum slice   |
  111. size.  You can check the current sizes of all slices by run-  |
  112. ing the Slice Status report.                                  |
  113.                                                               |
  114. All directories on the disk should be included in slices. Some|
  115. directories may not belong to any single person, but they     |
  116. should still be defined in a slice.  The best method is to    |
  117. create one or more System slices.  These are slices like any  |
  118. other, but they are owned by the "System".  Directories that  |
  119. typically are placed in a System slice are \DOS, \WINDOWS,    |
  120. etc.  If you name the System slices:  ~System1, ~System2, etc.|
  121. they will always appear at the end of the slice list.         |
  122.                                                               |
  123. Disk Police will never alter any file or directory on the     |
  124. shared disk.  It will never delete files when slice space has |
  125. exceeded the maximum limit.  It is a reporting system that    |
  126. shows who is in violation and why.  This allows you to take   |
  127. whatever action is necessary to maintain the shared disk      |
  128. space (for example, asking the owner of the slice to remove   |
  129. files).                                                       |
  130. TEXT_TERM ----------------------------------------------------|
  131. Add Slice                                                     |
  132.                                                               |
  133. The Add Slice menu item is used to add new slice defintions.  |
  134. A dialog box is used to provide the slice name, maximum size, |
  135. and directory list.  For shared network disks, the slice name |
  136. is commonly a person's name, but it can be anything.  Fill in |
  137. the information and select "Ok" or "Cancel".  The dialog box  |
  138. remains active until you select "Cancel" to allow you to enter|
  139. several slices.                                               |
  140.                                                               |
  141. Make up to 10 selections from the Available Directories list. |
  142. Use the "Select Dir" button to add the currently highlighted  |
  143. directory to the Slice Directories list.  Use the "Expand Dir"|
  144. button (or double click the mouse) on any directory or disk   |
  145. to see the list of sub-directories below it.  Expand the [..] |
  146. directory to see the list of directories above the currently  |
  147. displayed list.  Use the "Remove Dir" button to remove a      |
  148. directory from the Slice Directories list.                    |
  149.                                                               |
  150. The list of directories that make up a slice is always the    |
  151. full path name for each directory, including the disk name    |
  152. (C:, D:, etc.).  This allows support for partitioned disks    |
  153. and provides considerable flexibility in slice definitions.   |
  154. For example, a single slice can be used to keep track of space|
  155. owned by one person, even though the directories reside on    |
  156. multiple partitions (or even multiple disks).                 |
  157.                                                               |
  158. However, using full path names also means that network slice  |
  159. definitions may not be portable.  For example, a slice that   |
  160. references a directory on the network server as "N:\MYDIR"    |
  161. could not be physically moved over to the network server,     |
  162. since the server thinks of that same directory as "C:\MYDIR". |
  163. Just remember that, while it is perfectly acceptable to use   |
  164. any network computer to define slices for any server in the   |
  165. network, once the slice is defined it should remain on the    |
  166. same computer.                                                |
  167. TEXT_TERM ----------------------------------------------------|
  168. Update Slice                                                  |
  169.                                                               |
  170. The Update Slice menu item is used to update an existing slice|
  171. definition.  A dialog box is used to display and edit the     |
  172. slice definition.  First pick the slice to update from the    |
  173. list or currenly existing slices.  Then use the slice         |
  174. definition dialog box to update the slice definition as       |
  175. needed.  When complete, press "Ok" to save the change, or     |
  176. "Cancel" to leave the definition unchanged.                   |
  177.                                                               |
  178. Remove existing directories from the Slice Directories list or|
  179. make additional selections from the Available Directories     |
  180. list.  Use the "Select Dir" button to add the currently       |
  181. highlighted directory to the Slice Directories list.  Use the |
  182. "Expand Dir" button (or double click the mouse) on any        |
  183. directory or disk to see the list of sub-directories below it.|
  184. Expand the [..] directory to see the list of directories above|
  185. the currently displayed list.  Use the "Remove Dir" button to |
  186. remove a directory from the Slice Directories list.           |
  187.                                                               |
  188. See the Add Slice help topic for more information on          |
  189. portability of slice definitions for networked computers.     |
  190. TEXT_TERM ----------------------------------------------------|
  191. Remove Slice                                                  |
  192.                                                               |
  193. The Remove Slice menu item is used to remove an existing slice|
  194. definition.  Pick the slice to remove from the list of        |
  195. currently existing slices.  Press "Ok" to remove it, or       |
  196. "Cancel" to abort.                                            |
  197. TEXT_TERM ----------------------------------------------------|
  198. Reports                                                       |
  199.                                                               |
  200. Reports are the output from Disk Police and are selected from |
  201. the Reports menu item.  Three reports are available:          |
  202.                                                               |
  203.     Slice List      Provides a list of all currently defined  |
  204.                     slices.                                   |
  205.                                                               |
  206.     Slice Status    Checks each slice for space violations.   |
  207.                                                               |
  208.     Crumbs List     Checks a disk for files that lie outside  |
  209.                     of any slice.                             |
  210.                                                               |
  211. Each of these reports displays its information on the screen  |
  212. in the scrolling window.  The report may then be printed by   |
  213. selecting the Print menu item.                                |
  214.                                                               |
  215. See each individual report help topic for more information.   |
  216. TEXT_TERM ----------------------------------------------------|
  217. Slice List                                                    |
  218.                                                               |
  219. The Slice List report displays a list of all currently defined|
  220. slices.  This report consists of the name, maximum size, and  |
  221. directory list for each slice.                                |
  222.                                                               |
  223. Once the report has been displayed on the screen you can use  |
  224. the scroll bars to find the slice of interest or use the Print|
  225. menu item to print the list.                                  |
  226. TEXT_TERM ----------------------------------------------------|
  227. Slice Status                                                  |
  228.                                                               |
  229. The Slice Status report checks each slice for space viola-    |
  230. tions.  This is the principal purpose of the Disk Police pro- |
  231. gram.                                                         |
  232.                                                               |
  233. Each slice is examined one at a time.  Each directory in the  |
  234. Slice Directory list is checked for files, summing the file   |
  235. sizes.  Additionally, any sub-directories within the slice    |
  236. directory are examined, summing their file sizes, and follow- |
  237. ing down into their sub-directories.  This continues until the|
  238. sum of all files in the directory and all of its sub-         |
  239. directories is computed.  If this sum exceeds the maximum     |
  240. slice size limit, the slice is marked as being in violation.  |
  241.                                                               |
  242. This report takes no action against slices in violation, it   |
  243. only reports which slices are in violation and by how much.   |
  244. It is the responsibility of the slice owner to bring disk     |
  245. usage into compliance.                                        |
  246.                                                               |
  247. As the report runs (which can take several minutes for large  |
  248. disks), a status box shows which slice is in progress.  You   |
  249. may cancel the report at any time.                            |
  250.                                                               |
  251. Results are displayed on the screen.  Use the scroll bars to  |
  252. review it, or use the Print menu item to print the report.    |
  253. TEXT_TERM ----------------------------------------------------|
  254. Crumbs List                                                   |
  255.                                                               |
  256. The Crumbs List report examines a single logical disk (C:, D:,|
  257. etc.), looking for stray directories (crumbs) that are not    |
  258. included in any slice definition.  These directories represent|
  259. disk usage outside of the managed space, as defined by the    |
  260. slices.  As such, crumbs are considered violations, just like |
  261. slices that have exceeded maximum size limits.                |
  262.                                                               |
  263. A crumb is defined as a directory with at least one file that |
  264. is not included in any slice definition, and is not a sub-    |
  265. directory of another directory included in a slice definition.|
  266.                                                               |
  267. For example, if "\USER\JOHN" is a directory that is defined   |
  268. in a slice, then "\USER\JOHN\DOCS" cannot be a crumb, since   |
  269. it is a sub-directory to a directory that is defined in a     |
  270. slice.  Also, if "\USER" is not defined in any slice, but has |
  271. no files of its own (i.e. zero size, because it only contains |
  272. sub-directories), then it also is not a crumb.                |
  273.                                                               |
  274. However, another directory, say "\USER\JOHN2", that has files |
  275. and is not defined in any slice will be reported as a crumb.  |
  276. TEXT_TERM ----------------------------------------------------|
  277. Slice Monitor                                                 |
  278.                                                               |
  279. Use the Slice Monitor report to automatically monitor the     |
  280. status of slices.  This report is very similar to Slice Status|
  281. except that it runs by itself, repeatedly.  You designate how |
  282. often you wish to recheck the status of the slices.           |
  283.                                                               |
  284. Slice Monitor also differs from Slice Status in that you can  |
  285. choose to report violation slices only (Slice Status reports  |
  286. the status on all slices).                                    |
  287.                                                               |
  288. To start Slice Monitor, select it from the menu.  A dialog box|
  289. will be presented and will remain on the screen as long as    |
  290. monitoring continues.  Enter the number of minutes you wish   |
  291. to wait between successive slice checks (anything between 1   |
  292. and 9999 minutes).  To report violation slices only, check the|
  293. "Display violations only" check box.  If you check the "Auto  |
  294. print" check box, the results of each slice check will be     |
  295. automatically printed.                                        |
  296.                                                               |
  297. Press the Start Monitoring button to start monitoring slices  |
  298. for violations.  Monitoring will continue indefinately.  Press|
  299. the Stop Monitoring button to end the monitoring of slices.   |
  300.                                                               |
  301. Note that, while Disk Police is monitoring slices, you can    |
  302. change to any other Windows program, or make Disk Police an   |
  303. icon.  It will continue monitoring normally.                  |
  304. TEXT_TERM ----------------------------------------------------|
  305. Window                                                        |
  306.                                                               |
  307. Use this menu item to clear or print the current contents of  |
  308. the main window.                                              |
  309. TEXT_TERM ----------------------------------------------------|
  310. Clear                                                         |
  311.                                                               |
  312. The Clear menu item clears the contents of the main window.   |
  313. TEXT_TERM ----------------------------------------------------|
  314. Print                                                         |
  315.                                                               |
  316. The Print menu item is used to print a report.  First run the |
  317. report.  The output will be displayed in the window.  Then    |
  318. select Print to send it to the printer.                       |
  319.                                                               |
  320. Print always sends the last report run.  If no reports have   |
  321. been run since starting the program, Print will do nothing.   |
  322.                                                               |
  323. Print sends the output to the active Windows printer.  Refer  |
  324. to your Microsoft Windows User's Guide for information on     |
  325. installing printers.                                          |
  326. TEXT_TERM ----------------------------------------------------|
  327. Example of Use                                                |
  328.                                                               |
  329. The main reason to use Disk Police is to manage a network     |
  330. file server that is used by many people.  The example below   |
  331. shows how to define slices and run reports to manage this     |
  332. type of disk.  There are, however, other uses for the program |
  333. in addition to server management.                             |
  334.                                                               |
  335. Assume, for this example:                                     |
  336.                                                               |
  337.     1) A network with a 80 mb file server, partitioned into   |
  338.        three logical disk drives.  All system files (DOS,     |
  339.        WINDOWS, etc.) reside on the first partition.          |
  340.     2) Members of the network see the server disk partitions  |
  341.        as logical drives F:, G:, and H:, with partition sizes |
  342.        of 32 mb, 32 mb, and 16 mb respectively.               |
  343.     3) We wish to reserve 20% of the total disk space for     |
  344.        system use, provide another 20% for use by a special   |
  345.        project team, and divide the remainder equally among 6 |
  346.        network users as general disk space.                   |
  347.                                                               |
  348.                                                               |
  349. STEP 1.  DECIDE WHERE THE REPORTS WILL BE RUN                 |
  350.                                                               |
  351. When you define slices, full directory paths, including       |
  352. disk drive designations (C:, D:, etc.) are stored.  Thus      |
  353. the reports should be run on the same computer where the      |
  354. definitions were made to avoid network disk naming confusion. |
  355.                                                               |
  356. In most networks, it is best to use a network workstation as  |
  357. the place where the slices are defined and the reports are    |
  358. run - not the network server.  Avoiding the network server    |
  359. avoids memory limitations common to servers, allows the       |
  360. server to concentrate on file serving, and usually provides   |
  361. greater flexibility and convenience.                          |
  362.                                                               |
  363. Check to be sure that Windows recognizes the server by start- |
  364. ing Windows and observing the F:, G:, and H: drive icons.     |
  365.                                                               |
  366.                                                               |
  367. STEP 2.  DEFINE SYSTEM SLICES.                                |
  368.                                                               |
  369. Use Add Slice to create a System slice.  Don't worry about the|
  370. slice size for now:                                           |
  371.                                                               |
  372.     NAME        MAX SIZE        DIRECTORIES                   |
  373.                                                               |
  374.     System      0               F:\DOS                        |
  375.                                 F:\NETWORK                    |
  376.                                 F:\WINDOWS                    |
  377.                                 F:\SYS                        |
  378.                                 F:\BIN                        |
  379.                                 F:\SYSTEM1                    |
  380.                                 F:\SYSTEM2                    |
  381.                                                               |
  382. Note that you can't just define one slice and use F:\.  If    |
  383. you did, the reports generated wouldn't tell you anything     |
  384. useful.  You can name the System slices anything you wish.    |
  385. If you begin the name with "~", the slice will always appear  |
  386. at the end of the list, for convenience.                      |
  387.                                                               |
  388.                                                               |
  389. STEP 3.  RESERVE SYSTEM SPACE                                 |
  390.                                                               |
  391. Run the Slice Status report.  It will compute the current size|
  392. of the System slice you have defined (it will also report it  |
  393. as being in violation).  Decide how much space you would like |
  394. to reserve to allow future growth.  In this example,          |
  395.                                                               |
  396.                         CURRENT SIZE    WISH TO RESERVE       |
  397.                                                               |
  398.         System          6950 K          16384 K               |
  399.                                                               |
  400. This allows plenty of room for future growth in the System    |
  401. directories.  In fact, the System slice may never need all    |
  402. that space, but another System slice could be created later   |
  403. that would use it.  The space reserved is 16 mb, or 20% of the|
  404. total disk space.                                             |
  405.                                                               |
  406.                                                               |
  407. STEP 4.  ALLOCATE USER SPACE                                  |
  408.                                                               |
  409. We need 20%, or 16 mb, of the disk space for a special project|
  410. team.  These people don't need individual space, so a single  |
  411. slice will do.  Assuming the project team keeps their files in|
  412. one directory, then the slice definition is:                  |
  413.                                                               |
  414.     NAME        MAX SIZE        DIRECTORIES                   |
  415.                                                               |
  416.     ProjectX    16384 K         F:\PROJECTX                   |
  417.                                                               |
  418. This slice plus the System slice now account for all of the   |
  419. space on the F: partition.                                    |
  420.                                                               |
  421. The 6 network users get the remaining space, divided among    |
  422. them equally.  This is 48 mb total, 8 mb each.  Thus we define|
  423. 6 more slices, using directories created for user space on the|
  424. remaining partitions:                                         |
  425.                                                               |
  426.     NAME        MAX SIZE        DIRECTORIES                   |
  427.                                                               |
  428.     John        8192 K          G:\USER\JOHN                  |
  429.     Tara        8192 K          G:\USER\TARA                  |
  430.     Dave        8192 K          G:\USER\DAVE                  |
  431.     Jim         8192 K          G:\USER\JIM                   |
  432.     Carol       8192 K          H:\USER\CAROL                 |
  433.     Angela      8192 K          H:\USER\ANGELA                |
  434.                                                               |
  435. These slices now account for all of the remaining disk space. |
  436. Note that it is not necessary to account for all space.  For  |
  437. example, if more users are expected to join the network in the|
  438. future, it may be wise to give the existing users smaller     |
  439. allotments, leaving some space unaccounted for, but available |
  440. for future use.                                               |
  441.                                                               |
  442.                                                               |
  443. STEP 5.  RUN REPORTS                                          |
  444.                                                               |
  445. To review the slice definitions, run the Slice List report.   |
  446. This will also allow you to get a printed list of the slice   |
  447. definitions.                                                  |
  448.                                                               |
  449. To check for slice space violation, run the Slice Status      |
  450. report.  This report will check the contents of each slice,   |
  451. summing file sizes in every directory and sub-directory in    |
  452. the slice.  If the total file size exceeds the maximum slice  |
  453. limit, the slice will be marked as in violation.  The program |
  454. will NOT take any other action (such as removing files).  Its |
  455. job is to inform you so the owner of the slice can take the   |
  456. appropriate action to comply with the space restriction.      |
  457.                                                               |
  458. Use the Crumbs List report to identify stray files that have  |
  459. been created outside of the slice directories.  For example,  |
  460. if John creates the directory "G:\USER\JOHN2" and creates     |
  461. some files in it, the Crumbs report will flag that directory  |
  462. as a crumb (a stray directory).  Crumbs are violations of     |
  463. shared disk space, just as violations of maximum slice size.  |
  464.                                                               |
  465.                                                               |
  466. STEP 6.  MANAGE SLICES                                        |
  467.                                                               |
  468. Usually shared disks fill up because people don't take the    |
  469. responsibility of cleaning off unneeded files.  The Disk      |
  470. Police program takes care of that problem by reporting        |
  471. violators before their files consume the whole disk.          |
  472.                                                               |
  473. However, in some cases, users really need more space.  It     |
  474. is often a good policy to allocate a disk so that each user   |
  475. gets some minimum space (say 2 mb in this example).  When     |
  476. someone exceeds their limit, they should evaluate their space |
  477. needs and justify an increase in their limit.  If the space   |
  478. is available (and unallocated to other slices), then the      |
  479. increase in slice size is authorized.                         |
  480. TEXT_TERM ----------------------------------------------------|
  481.